home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / c / uux789 / uux.doc < prev   
Text File  |  1993-07-08  |  7KB  |  135 lines
  1.  
  2.             *** UUE ***
  3.  
  4. uue filename
  5. uue -n filename
  6. uue filename -
  7.  
  8. If given no args, uue will tells you what version is this, and the usage.
  9. The filename arg will be uuencoded.
  10. the -n option will yield several files, each n lines long.
  11. uue -500 niceprog.ttp will give:
  12. niceprog.uaa niceprog.uab ... niceprog.uaz (!!! that would be a lot),
  13. each (except the last) will be 500 lines long.
  14. If given, the final - character (not valid if -n is present) will send
  15. the output to stdout rather than a disk file.
  16. The filenames synthetized by uue will be at most 8 chars + .uue (or .uxx)
  17. to be in the accepted pattern for GEMDOS, MS/DOS, UN*X and TOPS20.
  18. ================================================================================
  19.  
  20. This is the v3.3 19-Apr-88 version of uud.ttp (and v3.1 of uue.ttp too)
  21. It is named uud instead of uudecode, to avoid confusion between different
  22. implementations of the uudecoding functionnality.
  23. Idem for uue.
  24.  
  25. These versions have the following capabilities:
  26. 1- Missing trailing blanks are still OK. (I am on EARN/BITNET ...)
  27.    Absolutely no need for any procedure to restore 61 chars a line...
  28. 2- **Some** common internetwork transpositions are OK (e.g. 
  29.    tilde instead of circonflex...but not coma instead of circonflex!) 
  30.    (I am still on EARN/BITNET)
  31.    No need to edit the file to change chars...
  32.    Note: I have been told that the substitution of blanks by grave
  33.    accent is not a gateway/network bug, but a feature of some recent
  34.    UN*X uuencode, to avoid the blank compression by some protocols.
  35.    Note: It is *NOT* BITNET/EARN that damage the files, we transfert non
  36.    encoded binaries on this network, but put the blame on some brain damaged
  37.    gateways. (One of them, between Usenet and Bitnet, is really ruining
  38.    files... Totally wrong ASCII -> EBCDIC table)
  39. 3- Multi-file decoding is OK, by the 'include xxx' and 'begin part n' lines.
  40.    To allow for identififation of the original file in the parts, the file
  41.    name is now provided in the 'begin part n' line.
  42. 4- If the included files do not exist, uud.ttp will attempt to go on with the
  43.    same file, in case the multiple files have just been concatenated upon
  44.    reception.
  45. 5- There is a line sequence checking possible, allowing the detection of
  46.    missing, duplicate, corrupted lines or files. (I have sloppy fingers when
  47.    editing ...)
  48.    This feature is enabled if the first line of the 1st uuencoded file
  49.    is postfixed with a 'z', this is done automatically by the uue.ttp
  50.    companion program.
  51.    Note: a bug of the previous version is fixed.
  52. 6- A complete check of the uudecoding process is possible, by use of the
  53.    -d flag. This will tell you about all whats going on in there, plus
  54.    this is enabling a complete character by character check of the file
  55.    while decoding. This should make some subtle file corruptions pop up,
  56.    as all the uudecode do not check whats in a line before doing their job.
  57.    If this option detect an error, then the file produced will not be
  58.    correct (uud stops at the first error detected, and close the file).
  59. 7- If there is a character table present before each file, it will be used,
  60.    this table is produced by the companion uue.
  61.    The use of this table allows for some incredible recovery of files that
  62.    went through some really brain damage gateway. No sweat.
  63. 8- You can decode a single file contaning several uuencoded files, at once;
  64.    You give a complete month of INFO-ATARI16 digest, and voila all the
  65.    nice PD .prg's, no editing, no sweat. (To be true, it's been a long time
  66.    without *.prg in the digests..., but you should try it.)
  67. 9- The files are completely compatible with true UN*X uudecode/uuencode.
  68.    As long as you do not use the multiple part option of uue.ttp.
  69. 10- Compile on the ST, using MWC, on UN*X System V and on TOPS20 using cc.
  70.  
  71.  
  72. En resume: get the mail file containing what you want to decode, on the
  73. Atari ST, and apply uud.ttp on it, without any editing of any sort, including
  74. removing mail header. (except for multiple parts, where the file names must be
  75. correct, but no need to edit individual files).
  76.  
  77.  
  78. uud v3.3 is the result of:
  79. 1. fixing a bug (nobody, but me, complained about it)
  80. 2. Having a source that compile and run successfully on
  81.    Atari ST, MS-DOS and UNIX. (Nobody got an Amiga around here)
  82.    I did the coding/compiling/testing for all 3 systems;
  83.    For UNIX, it is done using cc on a real/certified SystemVr2
  84.    For Atari, it is done using MWC 2.x.
  85.    For the PC, it is done with MSC 4.0. (An attempt with
  86.    Turbo C did not give me any thing that run correctly)
  87.    (I discovered a slight bug in MSC 4.0 too, but no big deal.)
  88. 3. Adding some requested features:
  89.    A. The -t option to allow for a full disk/directory target
  90.       specification, on which the uuencoded filename is appended.
  91.       The resulting pathname is where the result of the decoding
  92.       will be written.
  93.    B. The -s option: idem -t, but for the source file.
  94.    C. the -n option to disable the line sequence checking, in case
  95.       of uue'ed files, for any good/bad reason.
  96.  
  97.  
  98.    The maximum command line can thus be like:
  99.    uud -d -n -t c:^binaries^ -s d:^encoded^ file.uue
  100.    -d : enable the verbose/debugging option, telling you what
  101.       uud is doing, and sometimes even why...
  102.    -n : suppress the line sequence checking. (Totally useless option)
  103.       (The line checking is turned off automagically for files
  104.       that where not uuencoded by uue, even now for the files with
  105.       lines terminated by the 'z' char... no more fuzz about them...)
  106.    -t directory : where the output file(s) will be written, in this case
  107.       must be terminated by the directory separator character;
  108.    -s directory : where uud is going to find the file(s) to
  109.       decode.
  110. 4. This uud can decode line with 80 uuencoded char, instead of the
  111.    usual 60, the next generation of uue will take advantage of that.
  112. 5. If the file name on the command line,
  113.    is replaced by the character '-' then
  114.    standard input will be read, instead of a named file.
  115.    (For the heavy UNIX news reader...)
  116. 6. typing uud alone on a line, or invoking it without arguments
  117.    from the desktop, will give you the usage with a reminder
  118.    about the options.
  119.  
  120. Big news for Atari/PC users with only restricted disks,
  121. you can decode now much larger files, as the uud.ttp, source
  122. and destination files can all be on separate disks.
  123.  
  124. If given no args, uud will tells you what version is this, and the usage.
  125. With the -d option, a whole lot of checking is done, and it is telling
  126. you all that it is doing.
  127. In all case if there is anything else that a perfect decoding, you will
  128. have some message and you'll need to press any key to exit. (I anybody
  129. tell me how to tell if we are working from the desktop, or from a shell,
  130. I will make the pause valid only if run from the desktop. Some kind soul
  131. with an exemple ? I suppose I have to look into the base page...)
  132. In case of any error, the produced file is not valid.
  133.  
  134. ==============================================================================
  135.